home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / util / libs / graphics3d.readme < prev    next >
Encoding:
Text File  |  1998-10-31  |  11.6 KB  |  236 lines
  1. Short:    3D graphics shared library V13.01(beta)
  2. Author:   p.biancalani@mbox.match.it
  3. Uploader: p.biancalani@mbox.match.it
  4. Type:     util/libs
  5.  
  6. Version        13.01
  7.  
  8. --- English ----
  9. First sorry for my bad English but I don't know it very well.
  10. This is a simple but complete graphic 3D library that use for visualization
  11. only the system library .
  12. Main feature include :
  13.  
  14.    - Visualization of object in systems windows with single buffering.
  15.    - Support of polygons with one, two, tree and four vertex.
  16.    - Use of only fix point value than the math coprocessor is not
  17.      necessary, and is relatively fast on machines us A1200 base too.
  18.    - Implementation of visualization in Wire Frame ,Solid shading and
  19.      Flat shading all simultaneous too and with light source freely 
  20.      placeable .
  21.  
  22. Is tested on (for now): 
  23.    A4000/40 with S.O. 3.0
  24.  
  25. In this version I rewrite totaly the rendering function of library and
  26. I remove the use of blitter and shadow RastPort. 
  27. Now I use to render the scene a chunky buffer and I draw on it only 
  28. with CPU than I use the graphics.library function WritePixelArray8() 
  29. to transfer this on the visualization window.
  30. With this metod I have a big accelleration , on my machines (4000/40
  31. 25MHz 16Mbytes and a PicassoIV SO 3.0) on AGA screen is 2 time faster
  32. and on a Picasso screen almost 3 time.
  33. I thinks that with faster CPU and faster memory this speed up can be
  34. better test it and say to me.
  35.  
  36. But I have leave a version with the old metod of rendering for machines
  37. with 68000 or best but without fast memory (with only chip the new metod 
  38. is slower).
  39. I future it can be possible that I remove this old version than you are
  40. encourage to use the new one.
  41.  
  42. THIS LIBRARY IS A COPYRIGHT OF THE AUTHOR PATRIZIO BIANCALANI AND IS A 
  43. FREEWARE SOFTWARE THAN FREELY USABLE AND DISTRIBUITE BUT WITH ALL FILE OF 
  44. ORIGINAL ARCHIVE AND NOT FOR RESALE OR IT CAN'T BE SOLD, THAN I PROVIDE 
  45. ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
  46. IF YOU WANT MODIFY THE ORIGINAL SOURCES TELL ME THIS THAN ,IF IT IS OK, 
  47. I CAN UPDATE ALL ORIGINAL ARCHIVE.
  48. It is very pleasant if you send me an e-mail if you use it.
  49.  
  50. I have included an example write in E (and full commented) and all the source
  51. in C of this library .The executable is 3dlib and it must be in the same
  52. directory of #?.plg files. 
  53.  
  54. The file graphics3d_000_CPU.library is the library for CPU from 68000 with new metod of rendering.
  55. The file graphics3d_000_BLT.library is the library for CPU from 68000 with old metod of rendering.
  56. The file graphics3d_020_CPU.library is the library for CPU from 68020 with new metod of rendering.
  57. The file graphics3d_020_BLT.library is the library for CPU from 68020 with old metod of rendering.
  58. You must rename the correct library to graphics3d.library before use it.
  59.  
  60. Thanks to:
  61.    Maciej R.Gorny for the original routin of engine 3D.
  62.    Alessandro Franchi for beta testing on A1200.
  63.    VolKer Barthelmann author of VBCC the C compiler used by me to write the
  64.    library.
  65.    Andreas Kleinert author of the optimal startupcode for write shared
  66.    library. 
  67.    The authors of Tornado3D for the suggetions to implemented the single
  68.    buffering in a window. 
  69.    All ones that have write an e-mail to me.
  70.  
  71. I'am Patrizio Biancalani from Prato (Italy) and the my E-Mail for
  72. suggestions and signaling is :p.biancalani@mbox.match.it
  73.  
  74. Support site :www.amigaworld.com/support/graphics3dlib/welcome.html
  75.  
  76. --- Italiano ---
  77.  
  78. Questa e' una semplice ma completa libreria grafica 3D che si appoggia
  79. interamente sulle librerie di sistema per la visualizzazione.
  80. Le caratteristiche principali sono:
  81.    
  82.    - Visualizzazione oggetti nelle finestre con single buffering.
  83.    - Supporto di poligoni a uno, due, tre e quattro vertici. 
  84.    - Usa valori solo in fix point quindi il coprocessore non serve
  85.      ed e' relativamente veloce anche su macchine come il A1200 base.
  86.    - Implementa la visualizzazione in Wire Frame ,Solid shading e
  87.      Flat shading anche tutti contemporaneamente e con la fonte di 
  88.      luce posizionabile a piacere.
  89.  
  90. E' stata testata su(per ora):
  91.    A4000/40 con S.O. 3.0
  92.  
  93. In questa versione ho riscritto interamente le funzioni di visualizzazione
  94. e ho rimosso completamente l'uso del blitter e della RastPort nascosta.
  95. Ora uso un chunky buffer per visualizzare e vi disegno solo con la CPU
  96. poi uso la funzione WritePixelArray8() per trasferire il tutto sulla
  97. finestra di visualizzazione.
  98. Con quel sistema si ottiene una grande accellerazione, sulla mia macchina
  99. (4000/40 25MHz 16Mbytes e una PicassoIV) su uno schermo AGA e' 2 volte
  100. piu' veloce e su uno schermo Picasso quasi 3 volte.
  101. Penso che su macchine con CPU e memoria Fast piu' veloce quelle prestazioni
  102. possano ulteriormente migliorare, provate e ditemelo.
  103.  
  104. Ma ho lasciato anche una versione col vecchio metodo di visualizzazione
  105. per macchine con 68000 o migliori ma senza memoria fast (con solo la 
  106. chip la nuova e' piu' lenta).
  107. In futuro e' possibile che elimini questa vecchia versione quindi siete
  108. incoraggiati ad usare solo il nuovo metodo. 
  109.  
  110. QUESTA LIBRERIA E' UN COPYRIGHT DELL'AUTORE PATRIZIO BIANCALANI ED E' UN
  111. FREEWARE SOFTWARE QUINDI LIBERAMENTE DISTRIBUIBILE MA CON TUTTI I FILE
  112. DELL'ARCHIVIO ORIGINALE E NON PER FINI DI LUCRO, IO NON FORNISCO 
  113. ASSOLUTAMENTE ALCUNA GARANZIA SU QUESTO SOFTWARE.
  114. SE VOLETE MODIFICARE I SORGENTI ORIGINALI COMUNICATEMELO, SE E' ACCETTABILE
  115. IO AGGIORNERO' L'ARCHIVIO ORIGINALE.
  116. E' molto gradita la ricezione di un e-mail in caso di uso della libreria. 
  117.  
  118. Ho incluso anche un esempio di uso scritto in E e i sorgenti in C della
  119. libreria.L'eseguibile si chiama 3dlib e deve essere nella stessa directory
  120. dei file #?.plg .
  121.  
  122. Il file graphics3d_000_CPU.library e' per le CPU dal 68000 con nuovo metodo di visualizzazione.
  123. Il file graphics3d_000_BLT.library e' per le CPU dal 68000 con vecchio metodo di visualizzazione.
  124. Il file graphics3d_020_CPU.library e' per le CPU dal 68020 con nuovo metodo di visualizzazione.
  125. Il file graphics3d_020_BLT.library e' per le CPU dal 68020 con vecchio metodo di visualizzazione.
  126. Occorre rinominare la corretta libreria in graphics3d.library prima di
  127. usarla.
  128.  
  129. Si ringrazia :
  130.    Maciej R.Gorny per le routin del motore 3D.
  131.    Alessandro Franchi per il parziale beta testing su A1200.
  132.    VolKer Barthelmann autore del compilatore C VBCC da me usato per
  133.    la stesura della libreria.
  134.    Andreas Kleinert autore dell'ottimo startupcode per le shared
  135.    library. 
  136.    Gli autori di Tornado3D per il suggerimento su come implementare 
  137.    il single buffering in una finestra.
  138.    Tutti quelli che mi hanno scritto.
  139.  
  140. Io sono Patrizio Biancalani residente a Prato Italy e il mio E-Mail per
  141. suggerimenti e segnalazioni e': p.biancalani@mbox.match.it
  142.  
  143. Sito di supporto :www.amigaworld.com/support/graphics3dlib/welcome.html
  144.  
  145.  
  146. ============================= Archive contents =============================
  147.  
  148. Original  Packed Ratio    Date     Time    Name
  149. -------- ------- ----- --------- --------  -------------
  150.    12656    5599 55.7% 17-Oct-98 15:42:58  3dlib
  151.      351     181 48.4% 04-Nov-97 01:17:34  barrier.plg
  152.      590     235 60.1% 04-Nov-97 01:17:34  cube.plg
  153.     1552     597 61.5% 17-Oct-98 12:03:44 +graphics3D.fd
  154.     1883     951 49.4% 17-Oct-98 12:03:42 +graphics3D.i
  155.     1552     597 61.5% 17-Oct-98 12:03:44 +graphics3D.fd
  156.     2074     949 54.2% 17-Oct-98 12:25:16 +graphics3D_pubblic.h
  157.     2124     815 61.6% 17-Oct-98 12:14:52 +graphics3D_stub.lib
  158.      834     379 54.5% 17-Oct-98 12:03:44 +graphics3Dbase.h
  159.      631     305 51.6% 17-Oct-98 12:14:52 +graphics3D.m
  160.      452     253 44.0% 17-Oct-98 12:14:54 +graphics3D_lib.m
  161.    14558    4118 71.7% 17-Oct-98 15:31:10 +graphics3D.h
  162.     9556    3136 67.1% 13-Apr-98 12:09:46 +graphics3D.h.doc
  163.     1863     922 50.5% 22-Oct-98 22:53:10 +graphics3d.history
  164.     1394    1083 22.3% 26-Feb-98 23:35:00 +graphics3d.history.info
  165.     4459    1780 60.0% 19-Apr-98 19:36:54 +graphics3d.notes
  166.     1394    1084 22.2% 27-Feb-98 23:39:42 +graphics3d.notes.info
  167.    41708    9780 76.5% 17-Oct-98 14:51:20 +graphics3d_E.doc
  168.     1154     757 34.4% 27-Feb-98 23:35:52 +graphics3d_E.doc.info
  169.    55567   10674 80.7% 17-Oct-98 15:33:26 +graphics3D_E.guide
  170.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_E.guide.info
  171.    43591   10116 76.7% 17-Oct-98 14:48:48 +graphics3d_I.doc
  172.     1154     757 34.4% 27-Feb-98 23:35:44 +graphics3d_I.doc.info
  173.    57447   11097 80.6% 17-Oct-98 15:38:44 +graphics3d_I.guide
  174.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_I.guide.info
  175.     6759    2957 56.2% 23-Oct-98 23:56:06  graphics3d.readme
  176.    35672   15416 56.7% 16-Oct-98 20:01:42  graphics3d_000_BLT.library
  177.    36008   15804 56.1% 16-Oct-98 20:21:00  graphics3d_000_CPU.library
  178.    26316   13675 48.0% 15-Oct-98 19:28:46  graphics3d_020_BLT.library
  179.    26496   13962 47.3% 15-Oct-98 19:51:14  graphics3d_020_CPU.library
  180.      130      71 45.3% 04-Nov-97 01:17:34  ground.plg
  181.      186     101 45.6% 04-Nov-97 01:17:34  lettera.plg
  182.      773     402 47.9% 04-Nov-97 01:17:34  letterT.plg
  183.      140      93 33.5% 04-Nov-97 01:17:34  missile.plg
  184.      146     106 27.3% 04-Nov-97 01:17:34  plane.plg
  185.      365     175 52.0% 04-Nov-97 01:17:34  pylons.plg
  186.      944     418 55.7% 04-Nov-97 01:17:36  pyramid.plg
  187.      525     165 68.5% 28-Mar-98 12:27:50  rad.plg
  188.      267     155 41.9% 04-Nov-97 01:17:34  rock.plg
  189.     1146     394 65.6% 04-Nov-97 01:17:36  sfer.plg
  190.    30984    8128 73.7% 07-Dec-97 11:40:02  sfera.plg
  191.    30984    8132 73.7% 04-Nov-97 01:17:36  sfera1.plg
  192.    30984    8132 73.7% 04-Nov-97 01:17:34  sfera2.plg
  193.     9891    2576 73.9% 04-Nov-97 01:17:36  sfera_old.plg
  194.      481     221 54.0% 04-Nov-97 01:17:34  slider.plg
  195.    12035    4045 66.3% 17-Oct-98 12:42:18 +3dlib.h
  196.     8100    3038 62.4% 17-Oct-98 14:33:20 +3dlibdemo.e
  197.       16      16  0.0% 17-Oct-98 12:40:50 +3dlibh.h
  198.      129     102 20.9% 17-Oct-98 12:41:12 +compila
  199.    16336    4355 73.3% 28-Jan-98 21:27:22 +gad.h
  200.     2389     863 63.8% 13-Apr-97 09:58:52 +gen.h
  201.      631     305 51.6% 17-Oct-98 13:45:02 +graphics3D.m
  202.      452     253 44.0% 17-Oct-98 13:45:04 +graphics3D_lib.m
  203.      593     317 46.5% 17-Oct-98 12:03:54 +debuglib.c
  204.      269     152 43.4% 17-Oct-98 12:03:54 +debuglib.h
  205.     1552     597 61.5% 17-Oct-98 12:03:44 +graphics3D.fd
  206.    10155    3313 67.3% 17-Oct-98 12:03:42 +graphics3D.h
  207.     1883     951 49.4% 17-Oct-98 12:03:42 +graphics3D.i
  208.     5317    1566 70.5% 17-Oct-98 12:32:02 +graphics3D.make
  209.    15188    4318 71.5% 17-Oct-98 12:03:44 +graphics3D2d.c
  210.     1027     355 65.4% 17-Oct-98 12:03:44 +graphics3D2d.h
  211.    16227    4623 71.5% 20-Oct-98 00:02:18 +graphics3d2d_o.c
  212.      990     361 63.5% 17-Oct-98 12:03:44 +graphics3D2d_proto.h
  213.      834     379 54.5% 17-Oct-98 12:03:44 +graphics3Dbase.h
  214.      791     367 53.6% 17-Oct-98 12:03:44 +graphics3Dc.h
  215.    43923   10920 75.1% 17-Oct-98 12:03:42 +graphics3Df.c
  216.     4168     862 79.3% 17-Oct-98 12:03:42 +graphics3Df.h
  217.    30834    8451 72.5% 17-Oct-98 12:03:44 +graphics3Df_i.c
  218.     9130    2224 75.6% 17-Oct-98 12:03:44 +graphics3Df_i2.c
  219.     3840     849 77.8% 17-Oct-98 12:03:44 +graphics3Df_proto.h
  220.    11378    2533 77.7% 17-Oct-98 12:03:44 +graphics3Df_t.c
  221.     6637    2111 68.1% 20-Oct-98 00:13:30 +graphics3Dli.c
  222.      926     326 64.7% 17-Oct-98 12:03:46 +graphics3dm.c
  223.     2601     594 77.1% 17-Oct-98 12:03:46 +graphics3dm.s
  224.      607     352 42.0% 17-Oct-98 12:03:46 +graphics3Dm68k.c
  225.     8386    2175 74.0% 17-Oct-98 12:03:42 +graphics3Dsu.c
  226.      431     187 56.6% 04-Nov-97 01:17:34  station.plg
  227.     9891    2576 73.9% 04-Nov-97 01:17:36  tall_piramyd.plg
  228.      375     151 59.7% 04-Nov-97 01:17:36  tall_pyramid.plg
  229.      538     233 56.6% 04-Nov-97 01:17:34  tallon.plg
  230.      508     249 50.9% 04-Nov-97 01:17:34  tele.plg
  231.    13003    3401 73.8% 21-Feb-98 13:17:24  test.plg
  232.    21907    6195 71.7% 22-Oct-98 00:38:38  test1.plg
  233.      324     140 56.7% 04-Nov-97 01:17:34  tower.plg
  234. -------- ------- ----- --------- --------
  235.   765284  233563 69.4% 28-Oct-98 05:12:44   84 files
  236.